/*----------------------------------------------------------------------*
 *	INTERFACE:	Qt3ClassicalBoard
 *	Quantum Tic Tac Toe
 *	Copyright (c) 2004-2009 Novatia Labs, Inc.  All rights reserved.
 *----------------------------------------------------------------------*/
package com.novatialabs.qttt.engine;

/**
 * Qt3ClassicalBoard defines the interface to a classical Tic Tac Toe board.
 * A set of classical Tic Tac Toe boards are used to represent the individual
 * classical games that are super-positions of a Quantum Tic Tac Toe board.
 *
 * @Author	Duane Gibson
 * @Author Friendly development resources cheerfully provided by Charles Phares.
 * @Author	$Author$
 * @Version	$Revision$
 */
public interface Qt3ClassicalBoard
{

   /**
	* Returns the "owner" of the specified square.
	* Returns the constant Qt3Player.X if there is an "X" in the square.
	* Returns the constant Qt3Player.O if there is an "O" in the square.
	* Returns null if the square is empty.
	*
	* @throws IllegalArgumentException
	*	if the square number is &lt; 1 or &gt; 9.
	*/
	public abstract Qt3Player getPlayerInSquare(
	    int	squareNumber	// number of the square (1-9)
	    )
	    throws IllegalArgumentException;

}
